Skip to content

docs(changelog): every runner lease says whose workspace it belongs to - #168

Merged
indykish merged 3 commits into
mainfrom
chore/m149-runner-lease-reads-changelog
Jul 31, 2026
Merged

docs(changelog): every runner lease says whose workspace it belongs to#168
indykish merged 3 commits into
mainfrom
chore/m149-runner-lease-reads-changelog

Conversation

@indykish

@indykish indykish commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

Changelog entry for M149_001 — the runner lease workspace correlation and bounded read paths. Ships with agentsfleet/agentsfleet#584.

What the entry covers

  • Upgrading — the 30-day retention window measured from settlement, the four migrations that apply on startup (including the self-backfilling counter table), and the export-before-upgrade note for anyone reading raw lease history older than the window through GET /v1/fleets/runners/{id}/leases.
  • What's new — the Workspace column, the per-row funnel, and the deep-linkable ?workspace=<id> filter.
  • API reference — the new optional workspace_id filter, its 400 on a malformed value, and the empty-page answer for a well-formed identifier that owns nothing.
  • Bug fixes — the runner refusal that used to read as a fleet missing instructions, the account purge that never unregistered its scheduled runs, the stale lease link that now offers a way back instead of prescribing a refresh, and the runner page that no longer re-counts a host's whole history for four numbers.

Notes

Rebased onto main after M148's entry (#167) landed; both entries carry the same date, and this one sits above it because it ships second. No other page needed revision — the workstream adds no error code and no scope, and no published page documents the operator runner surface. Behavior that is documented (the lease endpoint's filter and the retention window) is stated in the entry's Upgrading and API reference sections.

🤖 Generated with Claude Code

Greptile Summary

Adds a changelog entry for runner lease workspace correlation and bounded history reads.

  • Documents the 30-day settled-lease retention window and startup migrations.
  • Describes workspace filtering in the runner UI and leases API.
  • Records account teardown, stale-link handling, and runner counter fixes.

Confidence Score: 5/5

The documentation-only PR appears safe to merge.

The new entry follows existing changelog structure and tag conventions, and its API, retention, migration, and UI descriptions do not conflict with an established published contract.

Important Files Changed

Filename Overview
changelog.mdx Adds a structurally consistent release entry documenting runner lease filtering, retention, migrations, and related fixes; no actionable issue was identified.

Reviews (1): Last reviewed commit: "docs(changelog): the abandoned-lease rea..." | Re-trigger Greptile

Context used:

indykish and others added 3 commits July 31, 2026 16:36
Covers the runner lease workspace filter, the 30-day retention window for
settled leases and their activity records, the startup-posture copy split,
the account-teardown schedule unregister, and the write-time lifetime
counters behind the runner page.

Load-bearing facts kept verbatim: the workspace_id filter on
GET /v1/fleets/runners/{id}/leases, its UZ-REQ-001 refusal, the
agentsfleet_account_teardown_unregister_failures_total counter, and the
30-day window.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
…entry

The Jul 31 runner-lease entry predates the review fixes it ships with.
Revised: the 30-day window is measured from settlement, not acquisition;
only the two per-lease activity records are pruned and the Activity feed
is kept at any age; four migrations apply, not three; starting_after
composes with the workspace_id filter and answers 400 UZ-REQ-001 across
filter contexts; one failed schedule unregister no longer strands the
rest; missing provider credentials count as failures; concurrent
deletions no longer starve the unregister pass of pool connections.

Load-bearing facts kept verbatim: GET /v1/fleets/runners/{id}/leases,
UZ-REQ-001, agentsfleet_account_teardown_unregister_failures_total, the
30-day window. History untouched: the M151 entry and older entries carry
through the rebase verbatim.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
…ay out

The second review round added two user-visible behaviours the entry did
not carry: a lease whose runner died on a fleet never used again is
marked expired once it passes the retention window and then keeps its
own window like any settled lease, and a bookmarked lease page the
server refuses now links to the newest leases instead of prescribing a
refresh that replays the same address.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@indykish
indykish merged commit 0340a9e into main Jul 31, 2026
3 checks passed
@indykish
indykish deleted the chore/m149-runner-lease-reads-changelog branch July 31, 2026 17:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant